Precondition:

•  fix(nx-plugin): print process output for CLI command #1095
• fix(nx-plugin): process output argument #1105
• feat(nx-plugin): adjust bin path handling #1109
• refactor: use utils in nx-plugin #1157
• refactor(nx-plugin): remove options merge #1158
• refactor(nx-plugin): set env vars if verbose is given #1159
• refactor(nx-plugin): add env vars to executor #1161
• refactor: adjust prefix logic #1189

This PR includes:

•  use plugin for main and cached targets
• use executor on all targets
• remove existing target configurations in projects
• add docs
• add validation helper script

Related:
closes #971

TODO Run local code

• https://github.com/nrwl/nx/blob/3d1e54481224e329865e77e019e2dadb75d1a9a7/packages/nx/src/plugins/js/utils/register.ts#L13-L28

tsx is a utility to run TypeScript files in node which is growing in popularity:
https://tsx.is

Behind the scenes it is invoking node with relevant --require and --import flags.

If the user is invoking Nx via a script which is being invoked via tsx, then we
do not need to register any transpiler at all as the environment will have already
been configured by tsx. In fact, registering a transpiler such as ts-node or swc
in this case causes issues.

Because node is being invoked by tsx, the tsx binary does not end up in the final
process.argv and so we need to check a few possible things to account for usage
via different package managers (e.g. pnpm does not set process._ to tsx, but rather
pnpm itself, modern yarn does not set process._ at all etc.).

Changes where tested by:

1. npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/nx-plugin@1091
2. add plugin inc options to nx.json

{
  "pluginsConfig": {
    "@code-pushup/nx-plugin": {
      "projectPrefix": "cli",
      "bin": "packages/cli/src/index.ts",
      "env": {
        "NODE_OPTIONS": "--import tsx",
        "TSX_TSCONFIG_PATH": "tsconfig.base.json"
      }
    }
  },
  "plugins": [
    {
      "plugin": "@code-pushup/nx-plugin",
      "options": {
        "targetName": "cp"
      }
    }
  ]
}